---
title: Migrando desde GitBook
description: Consejos para migrar un proyecto existente de GitBook a Astro
type: migration
stub: true
framework: GitBook
i18nReady: true
---

import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'

[Gitbook](https://gitbook.com) es una plataforma basada en la web para crear, publicar documentación y libros de manera colaborativa, con integración de control de versiones y funciones personalizables.


## Principales similitudes entre GitBook y Astro

GitBook y Astro comparten algunas similitudes que te ayudarán a migrar tu proyecto:

- Astro y GitBook admiten [Markdown](/es/guides/markdown-content/). Puedes migrar toda tu documentación existente utilizando la función Git Sync de GitBook.

- Tanto Astro como Gitbook usan algún tipo de [enrutamiento basado en archivos](/es/guides/routing/). El uso de la estructura de archivos de Astro para tu contenido existente y al agregar nuevas páginas debería resultarte familiar.

## Principales diferencias entre GitBook y Astro

Cuando migres tu documentación de GitBook a Astro, notarás algunas diferencias importantes:

- Un sitio de GitBook se edita usando un panel en línea. En Astro, usarás un [editor de código](/es/editor-setup/) y un entorno de desarrollo para mantener tu sitio. Puedes desarrollar localmente en tu máquina, o elegir un editor/entorno de desarrollo en la nube como StackBlitz, CodeSandbox o Gitpod.

- GitBook guarda tu contenido en una base de datos. En Astro, tendrás archivos individuales (típicamente Markdown o MDX) en tu [directorio de proyecto](/es/basics/project-structure/) para el contenido de cada página. O puedes elegir usar un [CMS para tu contenido](/es/guides/cms/) y usar Astro para obtener y presentar los datos.

- GitBook usa una sintaxis personalizada sobre Markdown para el contenido. Astro admite Markdoc a través de la [integración opcional de Markdoc](/es/guides/integrations-guide/markdoc/), que presenta una sintaxis similar a la que usarías en GitBook.


## Migrar de GitBook a Astro

Para migrar un sitio de documentación de GitBook a Astro, comienza con nuestra [plantilla oficial de inicio para documentación Starlight](https://starlight.astro.build) o explora más temas de documentación de la comunidad en nuestro [catálogo de temas](https://astro.build/themes?search=&categories%5B%5D=docs).

Puedes pasar el argumento `--template` al comando `create astro` para empezar un nuevo proyecto de Astro con una de nuestras plantillas oficiales. O, puedes [comenzar un nuevo proyecto desde cualquier repositorio de Astro existente en GitHub](/es/install/auto/#plantillas-de-inicio).

  <PackageManagerTabs>
    <Fragment slot="npm">
    ```shell
    npm create astro@latest -- --template starlight
    ```
    </Fragment>
    <Fragment slot="pnpm">
    ```shell
    pnpm create astro@latest --template starlight
    ```
    </Fragment>
    <Fragment slot="yarn">
    ```shell
    yarn create astro --template starlight
    ```
    </Fragment>
  </PackageManagerTabs>

Una vez que tengas un nuevo proyecto de Astro, puedes sincronizar tu contenido de GitBook existente con tu nuevo proyecto de Astro. GitBook tiene una función de [Git Sync](https://docs.gitbook.com/product-tour/git-sync) que sincronizará automáticamente tu contenido de GitBook con un repositorio de GitHub/GitLab.

Para sincronizar directamente con la colección de contenido de la plantilla de documentación, especifica `src/content/docs/en` o `src/content/docs` como el directorio del proyecto.

:::caution
Cuando habilites Git Sync, asegúrate de especificar "**GitBook a GitHub**" como prioridad. Esto asegurará que tu contenido de GitBook se sincronice con tu repositorio de GitHub. De lo contrario, sobrescribirás tu contenido de GitBook existente.
:::

Después de sincronizar el contenido, ahora tendrás una copia de tu contenido de GitBook en tu repositorio de Astro. Deshabilita la sincronización de git para evitar futuras sincronizaciones con GitBook.

Ten en cuenta que aunque ahora tienes tu contenido migrado a tu proyecto de Astro, no será inmediatamente utilizable. Para usar este contenido en tu sitio de Astro, necesitarás pasar algo de tiempo cambiando manualmente la sintaxis de GitBook a un formato compatible con Astro. En particular:

- La integración de [Markdoc de Astro](/es/guides/integrations-guide/markdoc/) requiere que la extensión del archivo sea `.mdoc`. Esto es para evitar conflictos con otras extensiones de Markdown como `.mdx` y `.md`.
- La sintaxis de GitBook difiere de Markdoc donde el prefijo `/` que denota una etiqueta de cierre se reemplaza con `end` para los archivos de GitBook. Necesitarás actualizar esta notación en todos tus archivos.
- Algunas características de GitBook dependen de componentes personalizados. Estos componentes no existirán en Astro y deben ser creados y agregados a tu proyecto a traves [del atributo `tags` de la configuración de Markdoc](/es/guides/integrations-guide/markdoc/#usa-componentes-astro-como-etiquetas-markdoc) o eliminados de tus archivos.

## Recursos de la comunidad

- ¡Añade el tuyo!
